<html>
<head><meta charset="utf-8"><title>pre-rfc: stable rustdoc URLs · general · Zulip Chat Archive</title></head>
<h2>Stream: <a href="https://rust-lang.github.io/zulip_archive/stream/122651-general/index.html">general</a></h2>
<h3>Topic: <a href="https://rust-lang.github.io/zulip_archive/stream/122651-general/topic/pre-rfc.3A.20stable.20rustdoc.20URLs.html">pre-rfc: stable rustdoc URLs</a></h3>

<hr>

<base href="https://rust-lang.zulipchat.com">

<head><link href="https://rust-lang.github.io/zulip_archive/style.css" rel="stylesheet"></head>

<a name="210582158"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/122651-general/topic/pre-rfc%3A%20stable%20rustdoc%20URLs/near/210582158" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/122651-general/topic/pre-rfc.3A.20stable.20rustdoc.20URLs.html#210582158">(Sep 18 2020 at 22:35)</a>:</h4>
<p>Going to make an RFC for this assuming nothing earth-shattering happens in the thread, but in the meantime posting here. Please comment on the internals thread, not here. <a href="https://internals.rust-lang.org/t/pre-rfc-stable-rustdoc-urls/13099/1">https://internals.rust-lang.org/t/pre-rfc-stable-rustdoc-urls/13099/1</a><br>
ping <span class="user-mention" data-user-id="120791">@RalfJ</span> <span class="user-mention" data-user-id="125270">@scottmcm</span> who expressed some interest in <a href="https://github.com/rust-lang/rust/issues/55160">https://github.com/rust-lang/rust/issues/55160</a></p>



<a name="210582221"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/122651-general/topic/pre-rfc%3A%20stable%20rustdoc%20URLs/near/210582221" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/122651-general/topic/pre-rfc.3A.20stable.20rustdoc.20URLs.html#210582221">(Sep 18 2020 at 22:36)</a>:</h4>
<p>(maybe this should have been in <a class="stream" data-stream-id="213817" href="/#narrow/stream/213817-t-lang">#t-lang</a> ?)</p>



<a name="210635427"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/122651-general/topic/pre-rfc%3A%20stable%20rustdoc%20URLs/near/210635427" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> scottmcm <a href="https://rust-lang.github.io/zulip_archive/stream/122651-general/topic/pre-rfc.3A.20stable.20rustdoc.20URLs.html#210635427">(Sep 19 2020 at 21:08)</a>:</h4>
<p>No, this is tools/docs/something.  While I like the idea, it has nothing to do with the language <em>itself</em>.  (If you wanted to make a rust compiler you could just not have rustdoc and still legitimately claim to have a rust compiler.)</p>



<a name="210643610"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/122651-general/topic/pre-rfc%3A%20stable%20rustdoc%20URLs/near/210643610" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/122651-general/topic/pre-rfc.3A.20stable.20rustdoc.20URLs.html#210643610">(Sep 20 2020 at 01:22)</a>:</h4>
<blockquote>
<p>If you wanted to make a rust compiler you could just not have rustdoc and still legitimately claim to have a rust compiler.</p>
</blockquote>
<p>oh hmm, I wasn't aware it was optional. does that mean all the tools are optional and you just need <code>rustc</code> itself?</p>



<a name="210652088"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/122651-general/topic/pre-rfc%3A%20stable%20rustdoc%20URLs/near/210652088" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Lokathor <a href="https://rust-lang.github.io/zulip_archive/stream/122651-general/topic/pre-rfc.3A.20stable.20rustdoc.20URLs.html#210652088">(Sep 20 2020 at 06:23)</a>:</h4>
<p><code>cargo</code> "just" reads <code>Cargo.toml</code> and invokes <code>rustc</code> appropriately, so that's actually optional.</p>



<a name="210652389"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/122651-general/topic/pre-rfc%3A%20stable%20rustdoc%20URLs/near/210652389" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> scottmcm <a href="https://rust-lang.github.io/zulip_archive/stream/122651-general/topic/pre-rfc.3A.20stable.20rustdoc.20URLs.html#210652389">(Sep 20 2020 at 06:34)</a>:</h4>
<p><span class="user-mention" data-user-id="232545">@Joshua Nelson</span> The more "official" answer is that the tools are the domain of <a href="https://www.rust-lang.org/governance/teams/dev-tools">https://www.rust-lang.org/governance/teams/dev-tools</a> and not of lang.</p>
<p>The tools are of course an important part of the ecosystem, but they're foundationally different from the language.  For example, there's no stability promise in the generated documentation.  And I could imagine someone being willing to use existing rustfmt and friends (because the output is visible) even if they insisted on making their own compiler (maybe because they have specific trusted-computing-base requirements).</p>



<a name="210665561"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/122651-general/topic/pre-rfc%3A%20stable%20rustdoc%20URLs/near/210665561" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/122651-general/topic/pre-rfc.3A.20stable.20rustdoc.20URLs.html#210665561">(Sep 20 2020 at 12:46)</a>:</h4>
<p><a href="https://github.com/rust-lang/rfcs/pull/2988">https://github.com/rust-lang/rfcs/pull/2988</a></p>



<a name="210665575"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/122651-general/topic/pre-rfc%3A%20stable%20rustdoc%20URLs/near/210665575" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/122651-general/topic/pre-rfc.3A.20stable.20rustdoc.20URLs.html#210665575">(Sep 20 2020 at 12:47)</a>:</h4>
<blockquote>
<p>For example, there's no stability promise in the generated documentation.</p>
</blockquote>
<p>Well, that's kind of the point of this RFC</p>



<a name="210665579"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/122651-general/topic/pre-rfc%3A%20stable%20rustdoc%20URLs/near/210665579" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/122651-general/topic/pre-rfc.3A.20stable.20rustdoc.20URLs.html#210665579">(Sep 20 2020 at 12:47)</a>:</h4>
<p>but I understand your point is that the formatting can change without warning</p>



<a name="211131482"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/122651-general/topic/pre-rfc%3A%20stable%20rustdoc%20URLs/near/211131482" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/122651-general/topic/pre-rfc.3A.20stable.20rustdoc.20URLs.html#211131482">(Sep 24 2020 at 13:34)</a>:</h4>
<p><span class="user-mention" data-user-id="245610">@Jacob Pratt</span> I noticed you reacted with <span aria-label="confused" class="emoji emoji-1f615" role="img" title="confused">:confused:</span> on the RFC - are you not sure why I made the RFC? Or not sure that it's an improvement?</p>



<a name="211131535"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/122651-general/topic/pre-rfc%3A%20stable%20rustdoc%20URLs/near/211131535" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/122651-general/topic/pre-rfc.3A.20stable.20rustdoc.20URLs.html#211131535">(Sep 24 2020 at 13:34)</a>:</h4>
<p>(didn't want to call you out on the RFC itself :P)</p>



<a name="211135644"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/122651-general/topic/pre-rfc%3A%20stable%20rustdoc%20URLs/near/211135644" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Jacob Pratt <a href="https://rust-lang.github.io/zulip_archive/stream/122651-general/topic/pre-rfc.3A.20stable.20rustdoc.20URLs.html#211135644">(Sep 24 2020 at 14:05)</a>:</h4>
<p>Not an issue! Consider it a "-0.5". I fully understand what's being proposed, and have been following it on internals as well. I don't have any technical objections whatsoever, just a general "is this actually an issue" kind of feeling.</p>



<a name="211940875"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/122651-general/topic/pre-rfc%3A%20stable%20rustdoc%20URLs/near/211940875" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/122651-general/topic/pre-rfc.3A.20stable.20rustdoc.20URLs.html#211940875">(Oct 01 2020 at 16:59)</a>:</h4>
<p>fyi <span class="user-mention" data-user-id="120791">@RalfJ</span>  <span class="user-mention" data-user-id="125270">@scottmcm</span> I'm probably not going to put much more effort into this RFC, if you want to see it accepted feel free to take it over</p>



<a name="212163594"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/122651-general/topic/pre-rfc%3A%20stable%20rustdoc%20URLs/near/212163594" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> RalfJ <a href="https://rust-lang.github.io/zulip_archive/stream/122651-general/topic/pre-rfc.3A.20stable.20rustdoc.20URLs.html#212163594">(Oct 03 2020 at 09:52)</a>:</h4>
<p>That's fair. I am also unlikely to push for it, there are things that have higher priority for me.</p>



<hr><p>Last updated: Aug 07 2021 at 22:04 UTC</p>
</html>